<!-- Copyright 2008-2010 Daniel Cachapa <cachapa@gmail.com> -->
 
<html>
<body text="#eeeeee" bgcolor="#000000" link="#0044ff">

<center><h2>Libra Help</h2></center>

<strong>Libra</strong> tracks your daily weight using a 10-day trend line suggested by
<a href="http://www.fourmilab.ch/hackdiet/www/hackdiet.html">The Hacker's  Diet</a> to
"absorb" day-to-day fluctuations and help you better monitor your progress, keeping you motivated.

<h3>Using Libra</h3>
<strong>Enter your weight</strong>. Select Menu. Select <strong>Insert  Value</strong>.
Use the date field to set date for Weight Value (Libra defaults to today's date).
Swipe the measuring tape right or left to your weight and press the Insert button
on the bottom.<br/><br/>

<i>Tip: You can long-press any chart to quickly reach the insert value screen.</i><br/><br/> 

Libra only allows one weight entry per date. To  replace a Weight Value, tap the
chart to see a database list of values for that chart. Long-press the weight value
and select delete. Then go back to the main menu and insert a new value for the
same date.<br/><br/>

<strong>Viewing the charts</strong>. Libra offers 3 chart views -- Monthly (default),
Yearly, and  Complete. Select Menu to see the different chart modes.<br/>
Swipe chart left or right to see previous or following month (or year) for which
there are data.<br/><br/>

<strong>Sharing the chart</strong>. In the menu, there is an option to share the
current chart. This function saves the image as a file in the root of your SD card
with the file name "Libra.png" and offers you a list of applications with which
to share the image. Typically these applications are email clients, photo
sharing services (such as Picasa), or social networking apps, such as
Facebook or Twitter, if they are installed and support that functionality.<br/><br/>

<strong>Viewing the weight entries</strong>. Tap a chart to see a list of the entries on that
chart. For example, if you tap the chart for a given month, you will see the entries
for that month. <b>Select the menu</b> on this view to show the complete database.<br/>
<strong>Tap one of the entries</strong> to edit that entry.<br/>
<strong>Long-press an entry</strong> to bring up a menu from which it is possible to either edit
or delete the selected entry.<br/>
When looking at the complete database, open the Menu to access further functionality:
<ul>
<li><strong>Export database</strong> will write the full database to a file in
your SD card's root called "Libra.csv". This file is in a format which can be
imported in a spreadsheet application.</li>
<li><strong>Import database</strong> will import a database from a file in
your SD card's root with the name "Libra.csv". This file is in the same format
as the previous one. Read the section "Importing Data" below for more information on
the file format.</li>
<li><strong>Delete database</strong> will delete the whole database. Beware that
there is no way to undo this action.</li>
</ul>

<h3>Reading the Chart</h3>

<ol>
<li><strong>Trend Line</strong> (solid red line). 10-day moving average of your daily
weight changes.</li>
<li><strong>Weight</strong> (white-red dot). Daily weight value entered.</li>
<li><strong>Floaters</strong> (gray line up) and <strong>Sinkers</strong>
(gray line down). Variation in Weight and Trend Line. The longer the line,
the stronger you're "pulling" the weight trend in that direction.</li>
<li><strong>Expected Trend Line</strong> (dashed red line). Forecast of
progress toward Weight Goal.</li>
<li><strong>Weight Goal</strong> (solid blue line). Goal entered under
Preferences.</li>
<li><strong>BMI Classification</strong> (dashed yellow line). Border line when
approaching a new classification based on Body Mass Index, a ratio of weight and
height.</li>
</ol>

<h3>Statistics</h3>

<ol start=7>
<li><strong>Current Trend</strong>. Value of your current weight trend.</li>
<li><strong>BMI</strong> and <strong>Classification</strong>, from Obese Class III
to Normal to Starvation.</li>
<li><strong>Trend Variation</strong>. Difference between start and end points
of Trend Line for the current chart.</li>
<li><strong>Forecast</strong>. The expected trend change for the next 7 days
and daily calorie average, based on your current trend. Note: 1 Kg of fat is roughly
7700 Kcal. 1 lbs of fat equals to about 3500 Kcal.</li>
<li><strong>Goal</strong>. Weight Goal entered under Preferences.</li>
<li><strong>Expected</strong>. Forecast date for reaching Weight Goal based on
Current Trend. Note: If trending away from your goal, date will read "Unknown."</li>
</ol>



<h3>Preferences</h3>
<ul>
<li><strong>Goal Weight</strong>. Set your target weight. Libra will draw a dashed
line in the chart so you can always see how far you are from your goal. Hint:
set reachable milestones instead of a more long-term, harder-to-reach goal.</li>
<li><strong>Show expected goal date</strong>. Ask Libra to calculate
how long it will take you to reach your goal based on your trend.</li>
<li><strong>Always show goal line</strong>. Zoom the chart so that the goal is always
visible.</li>
<li><strong>Show expected trend line</strong>. Draw a dashed line from the last
entry to the expected goal date.</li>
</ul>

<h3>Importing Data</h3>
Understanding how Libra imports data may help you import your database from another
source without having to go through the trouble of inserting each value manually.<br/>
Libra will import data from a text file named "Libra.csv" in the root directory of your
SD card.<br/>
The data inside the file is interpreted as one entry per line, formated as YYYY-MM-DD;Weight<br/><br/>

For example:<br/>
2010-04-25;195.4<br/>
2010-04-26;195.2<br/>
2010-04-27;194.8<br/><br/>

When Libra exports the database, the trend value will also appear after the weight.
That value is not, however, required during import since Libra will regenerate the
trend values after importing.<hr/>





<center><h2>Frequently Asked Questions</h2></center>

<b>How do I set the goal date?</b><br/>
There is no way to enter the goal date directly. The goal date is
calculated automatically based on your trend change from the previous
7 days, and your goal weight.<br/>
If you are trending away from the goal weight, the goal date will
appear as "unknown".<hr/>

<b>The weight/BMI values are wrong.</b><br/>
Most of the time, this is related to the measurement units (Kg, lbs, etc.).<br/>
Libra tries to guess which units you're using based on your device's language,
but the setting may be wrong for you. Simply go to the preferences menu and
change the settings there.<br/>
If that doesn't fix the problem, then it's probably a bug. Please send me an
email so that I can track it down.<hr/>

<b>How about using Libra to track body fat percentage?</b><br/>
This will be implemented eventually. The process is hanging on the need to make changes to the database
structure, and the value insertion interface. Unfortunately, I can't give a timeframe for this.<hr/>

<b>I imported my values from DailyBurn, but I only get around two months of data in Libra even though I
have more entries in DailyBurn.</b><br/>
This is due to a limitation of DailyBurn's synchronisation interface. Currently their
implementation only allows the download of the latest 50 entries, so Libra is limited to that number.<br/>
DailyBurn's people are working on that, though, so as soon as it's available, I will update the interface
in order to support it.<br/>
In the meanwhile, it is possible to create a .csv file which Libra will understand and manually import the
values from the DailyBurn database. This process is described above in this help file, but if you have problems,
please don't hesitate to contact me directly.<hr/>





<center><h2>Final Words</h2></center>
Before starting any diet regime, be sure that you're not putting your
health at risk. In case of doubt, consult with your physician.

<h3>About the Body Mass Index (BMI)</h3>
Though Libra uses BMI values extensively, it should be made clear what BMI is and
isn't.<br/>
BMI is a statistical measure which compares a person's weight and height. Since the
weight ignores your body's composition, the expected BMI values will fall out of
range for people with unusual body types, such as body builders with considerable
muscle mass.<br/>
That means that while the BMI is a decent indicator for the average person, it
doesn't represent everyone. For this reason, some people may disregard completely
the BMI values as they may not represent them. Libra uses the BMI values only as
references in the chart, and as a helper when setting your goal weight.

<h3>Last but not least...</h3>
I hope you have fun reaching your goals and find Libra useful.<br/><br/>

If you have any questions, comments, or bug reports, please feel free to send 
me an email to <a href="mailto:cachapa@gmail.com">cachapa@gmail.com</a>.<br/><br/>

And if you'd like to see Libra translated in your native language, I would love
to have your help in doing so. It consists of translating a small text file which
should take around 20 minutes, and you'd have my undying gratitude :-)

</body>
</html>